home *** CD-ROM | disk | FTP | other *** search
/ Aminet 21 / Aminet 21 (1997)(GTI - Schatztruhe)[!][Oct 1997].iso / Aminet / hard / drivr / StScan.readme < prev    next >
Encoding:
Text File  |  1997-09-05  |  9.3 KB  |  233 lines

  1. Short:    StScan V3.01D - ST-400 scanner software
  2. Author:   Frank-Christian Kruegel, Henning Peters, Andreas R. Kleinert
  3. Uploader: Andreas_Kleinert@t-online.de
  4. Type:     hard/drivr
  5.  
  6.  
  7. Siemens ST 400 Scanner software
  8. -------------------------------
  9.  
  10.    For: ST-400 scanner, OS 2.04+, 68020+
  11.         (works with AGA and graphics card, but
  12.          e.g. NewMode is needed with the latter)
  13.  
  14.  
  15.  This scanner software has been written by Frank-Christian Kruegel
  16.  <FCHK@MLO.ZER> in 1991-92 and published under the GNU General Public
  17.  License V1. Later on, Henning Peters <faroul@beyond.hb.north.de>
  18.  tried to get the stuff running under newer OS and hardware, but
  19.  although he did make some changes to the source (for GCC), it
  20.  did not work as expected. He asked for some advice in a german
  21.  newsgroup, and since I was interested in the program, I asked
  22.  him for the source and did some modifications. Me, that
  23.  is Andreas R. Kleinert <Andreas_Kleinert@t-online.de> and
  24.  here's the - possibly incomplete - list of changes done:
  25.  
  26.  
  27.  16 Aug 1997: V3.01D      [ Andreas R. Kleinert ]
  28.  
  29.                - recompiled with SAS/C V6.58
  30.                - view() had been commented out (imginout.c)
  31.  
  32.  11 Aug 1997: V3.00D      [ Andreas R. Kleinert ]
  33.  
  34.                - did all necessary modifications for
  35.                  SAS/C V6.57, MC 68020 recompilation
  36.                - removed/changed several odd/obsolete data
  37.                  definitions
  38.                - ANSIfied the source code, added header files
  39.                - adjusted the assembler source pieces for
  40.                  SAS/C ASM
  41.                - removed unused variables
  42.                - replaced header files with newer versions
  43.                - removed compatibility header kludges
  44.                - added copy of GNU General Public License V2
  45.                - fixed some bugs, e.g. often char wtitle[20]
  46.                  was refered to as &wtitle instead of &wtitle[0]
  47.                  and increased its varying sizes
  48.                - removed references to "a_lib" includes
  49.                - added descriptive headers to all source/include
  50.                  files
  51.                - most includes are done within stscan.h now,
  52.                  no more redundant/differing stuff
  53.                - prefs now located in PROGDIR:
  54.                - __USE_SYSBASE defined ;)
  55.                - still missing: explicite AGA support
  56.                - etc. etc. etc.
  57.  
  58.  1997:        V2.50D mod. [ Henning Peters ]
  59.  
  60.                - small changes
  61.  
  62.  1991/92:     V2.50D      [ Frank-Christian Krügel ]
  63.  
  64.                - initial release
  65.  
  66.  
  67.  
  68.  Below is the original, german only, LIESMICH text:
  69.  
  70.  *******************************************************************
  71.  
  72. Siemens ST 400 Scanner- und Bildverarbeitungssoftware
  73. -----------------------------------------------------
  74.  
  75. Author und Copyright 1991/92 bei:
  76.  
  77. Frank-Christian Krügel
  78. Rabienstraße 52
  79. W-2862 Worpswede (Achtung! Ab 1.7. neue PLZ: 27726)
  80. Germany
  81.  
  82. Fido:   2:240/300.44
  83. Z-Netz: FCHK@MLO.ZER
  84. Usenet: fck@finland.fido.de oder (wenn's gar nicht anders geht)
  85.         a02e@alf.zfn.uni-bremen.de
  86.  
  87. Telefon/Telefax: 04792-894 (nur zu verkehrsüblichen Zeiten, ansonsten drohen
  88.                             Kabelbrand, Überfaxe und Briefbomben!)
  89.  
  90. Lizenz:
  91.  
  92. Dies ist freie Software; Du darfst sie unter Beachtung der GNU General Public
  93. Licence, wie sie von der Free Software Foundation in der Version 1 herausgegeben
  94. wurde, weiterverbreiten und/oder modifizieren.
  95.  
  96. Dieses Programm wird in der Hoffnung verbreitet, daß es einigen Leuten
  97. nützen möge.  Ich garantiere jedoch für überhaupt gar nichts, nur daß die
  98. Software Speicherplatz auf der jeweiligen Platte oder Diskette einnimmt.
  99.  
  100. Ein Exemplar der GNU General Public Licence ist dem Programm beigefügt
  101. (File:  GNU_COPYLEFT); falls es fehlt, kann es bei folgender Adresse
  102. angefordert werden:  Free Software Foundation, Inc., 675 Mass Ave,
  103. Cambridge, MA 02139, USA.
  104.  
  105. Sinn und Zweck:
  106.  
  107. Dieses Programm dient dazu, einen Flachbettscanner mit SCSI-Bus über
  108. den Amiga ansteuern zu können. Hierfür können die Größe (DIN A6, A5 und A4),
  109. die Auflösung (200, 300 und 400 DPI) und die Anzahl an Graufstufen (2 oder 16)
  110. eingestellt werden.
  111. Der Sacnner erzeugt eigentlich 64 Graustufen. Da solche Bilder aber bis zu
  112. 16MB an Speicher verbrauchen und ein normaler ECS-Amiga nur 16 Graustufen
  113. anzeigen kann, werden die beiden niederwertigsten Bits ignoriert.
  114.  
  115. Bilder können im IFF-IBLM-Format gespeichert und wieder geladen werden.
  116. Das Speichern kann entweder unkomprimiert oder mit der standardmäßigen
  117. Packbits-Kompression geschehen. Der Filerequester benutzt die req.library,
  118. die hierzu vorhanden sein muß.
  119.  
  120. Das Bild wird entweder 1:1 oder verkleinert als Ganzseitenansicht dargestellt.
  121. Zwischen den beiden Darstellungsformen kann mit dem Gadget in der rechten unteren
  122. Ecke umgeschaltet werden. Im Konfig.Menü kann der verwendete Bildschirmmodus
  123. (ab Kick 2.0) und das verwendete SCSI-Device eingestellt werden. Bei der
  124. Interlace-Einstellung gibt es bei Verwendung des 2024-Graustufenmonitors
  125. eine Besonderheit. Dort wird mit der Interlace-Einstellung nämlich zwischen
  126. 10Hz und 15Hz umgeschaltet. Aufgrund von Hardwarebeschänkungen beim
  127. ECS-Chipsatz können in einigen Grafikmodi nur vier Graustufen dargestellt
  128. werden. Intern wird jedoch immer mit 16 Grafustufen gerechnet.
  129. Eine Anpassung an die neuen AA-Grafikmodi wird erfolgen, sobald mir jemand
  130. einen 4000'er mit SCSI-Controller schenkt.
  131.  
  132. Zusätzlich sind noch eine Reihe von Bildbe- und Bildverarbeitungsfunktionen
  133. eingebaut. Einige sind nur bei Graustufenbildern möglich, andere nur bei
  134. Bilevel- (Schwarzweiß-)Bildern.
  135.  
  136. Funktionen für Graustufenbilder:
  137. - Histogramm zur Anzeige der Häufigkeit der einzelnen Helligkeitswerte
  138. - Konstrastverstärkung
  139. - Lokale Operatoren (Hochpaß, Tiefpaß, Relief, Maximum-, Minimum- und Median-
  140.   Operator)
  141. - Umwandlung in Bilevel-Bilder durch Schwellwertbildung oder Dithern (ordered
  142.   Dither und Floyd-Steinberg)
  143.  
  144. Funktionen für Bilevel-Bilder:
  145. - Umwandlung in Graustufenbilder
  146. - Ausdünnung (Vorstufe zur Vektorisierung)
  147. - Vektorisierung eines ausgedünnten Bildes)
  148.  
  149. Funktionen für beide Bildarten:
  150. - Invertierung
  151. - Spiegelung (horizontal, vertikal)
  152. - Ausschneiden eines Bereiches
  153.  
  154. Vektorisierung:
  155. rasterbilder können in ein Vektorformat umgewandelt werden. Hierzu
  156. muß man in drei Stufen vorgehen:
  157. - Scannen oder Laden eines Bilevel-Bildes
  158. - Ausdünnen
  159. - Vektorisieren
  160.  
  161. Als Ergebnis erhält man eine Textdatei, die z.B. mit IntroCad oder UltraCad
  162. geladen werden kann. Beim PD-Programm "MPLOT" sind Hilfsprogramme dabei,
  163. mit denen man solche Dateien in das ICAD-Binärformat, das von Aegis Draw oder
  164. das DXF-Format umwandeln kann.
  165. Die erzeugten Textdateien haben das folgende Format:
  166. <x11> <y11>     \
  167. <x21> <y21>     /erster Vektor
  168.                 Leerzeile als Trenner
  169. <x12> <y12>     \
  170. <x22> <y22>     /nächster Vektor
  171.                 Leerzeile als Trenner
  172. ....
  173.  
  174.  
  175. Achtung! Während der Vektorisierung wird jeder erkannte Punkt im Speicher
  176. gelöscht, damit er nicht zweimal erkannt wird. Wenn das Bild noch benötigt
  177. wird, vorher speichern!
  178.  
  179. Voraussetzungen:
  180. - diese Disk
  181. - ein Amiga
  182. - am Besten ein flimmerfreier Bildschirm
  183. - ein SCSI-Controller mit dem von Commodore festgelegten "Exec level Direct
  184.   SCSI" Software-Interface
  185. - so viel zusammenhängender Speicher wie irgendwie möglich
  186. - ein passender Scanner
  187. - die req.library
  188. - Zum Neucompilieren zusätzlich entspechende Kenntnisse und Aztec C 5.0 oder
  189.   5.2 Mit Lattice C sollte es auch gehen, den habe ich aber nicht
  190.  
  191. Start: einfach Programm per Doppelklick oder CLI aufrufen.
  192. Der Scanner muß vorher angeschlossen, angeschaltet und betriebbereit sein.
  193. Der Siemens-Scanner ST400 ist hardwaremäßig auf Target ID 3 und Target LUN 3
  194. eingestellt. Auf dieser ID dürfen also keine anderen Geräte liegen.
  195.  
  196. Funktionsbereschreibung des Siemens-Scanners:
  197. siehe die englische Anleitung. Ich bin ja so tippfaul.
  198.  
  199.  *******************************************************************
  200.  
  201.  
  202. ============================= Archive contents =============================
  203.  
  204. Original  Packed Ratio    Date     Time    Name
  205. -------- ------- ----- --------- --------  -------------
  206.    17982    6993 61.1% 11-Aug-97 12:21:22 +COPYING
  207.      923     413 55.2% 11-Aug-97 12:41:12 +imginout.h
  208.    13242    1434 89.1% 11-Aug-97 12:42:10 +localop.c
  209.      405     220 45.6% 11-Aug-97 12:40:28 +localop.h
  210.     6735    1906 71.7% 11-Aug-97 12:42:02 +pixelop.c
  211.      481     253 47.4% 11-Aug-97 12:40:10 +pixelop.h
  212.     7742    3654 52.8% 11-Aug-97 13:02:26 +README
  213.     1367     352 74.2% 11-Aug-97 12:38:22 +scnplane.h
  214.    16256    1260 92.2% 11-Aug-97 12:38:46 +scnplane.s
  215.      173     136 21.3% 11-Aug-97 12:52:36 +scoptions
  216.      564     199 64.7% 11-Aug-97 12:19:38 +smakefile
  217.      835     390 53.2% 11-Aug-97 11:58:10 +StScan.info
  218.     8323    2275 72.6% 11-Aug-97 12:41:48 +vectorop.c
  219.      303     202 33.3% 11-Aug-97 12:37:36 +vectorop.h
  220.    49160    7320 85.1% 16-Aug-97 09:18:54 +imginout.c
  221.    15028    8839 41.1% 16-Aug-97 09:54:12 +imginout.o
  222.     5564    2565 53.9% 16-Aug-97 09:55:48 +localop.o
  223.     4184    2444 41.5% 16-Aug-97 09:21:18 +pixelop.o
  224.     1944     573 70.5% 16-Aug-97 09:55:52 +scnplane.o
  225.    58264   31844 45.3% 16-Aug-97 09:59:38 +StScan
  226.    42096    8237 80.4% 16-Aug-97 09:58:48 +stscan.c
  227.     1923     754 60.7% 16-Aug-97 09:20:04 +stscan.h
  228.    19044    8703 54.3% 16-Aug-97 09:59:34 +stscan.o
  229.     7899    3701 53.1% 16-Aug-97 09:58:26 +StScan.readme
  230.     5580    3032 45.6% 16-Aug-97 09:21:50 +vectorop.o
  231. -------- ------- ----- --------- --------
  232.   286017   97699 65.8% 21-Aug-97 19:25:44   25 files
  233.